leapbtw / altserver-pi

AltServer docker container for raspberry pi 4

Altserver-Pi

AltServer docker container for raspberry pi 4

Steps

0. Install docker and docker-compose

   • Install docker and docker-compose

1. Clone the repo on the raspberry

   git clone https://github.com/leapbtw/altserver-pi.git && cd altserver-pi

2. Install pairing software

   • Install libimobiledevice and usbmuxd.
   • This software is only needed once for pairing, you can perform these steps on a different machine and copy the files to the raspberry later. Package names may vary between distributions, so please check the appropriate package names for your system.

3. Pair Your iDevice

   • Connect your iDevice to your PC and run:

     idevicepair list # run and check your iDevice, might ask for passcode
     idevicepair pair

4. Copy Pairing Files

   • Copy the .plist files to the root of the cloned repo on the raspberry:

     cp /var/lib/lockdown/*.plist .

5. Verify Repository Structure

   • Your folder structure should look something like this:

     $ ls
     docker-compose.yaml  Dockerfile  provision_config  README.md  startup_script.sh  <uuid>.plist  SystemConfiguration.plist

6. Set Permissions

   • Set the necessary permissions for the provision_config directory:

     chmod 777 provision_config/

7. Start the Docker Container

   • Start the container using Docker Compose:

     docker compose up

Now you should be able to use the altserver application on your Raspberry Pi 4.

8. If you want it to run at startup you could create a systemd service like this
   • Create a new file for your systemd unit:

     sudo vim /etc/systemd/system/altserver.service

   • Add the following content to the file, modifying the paths as needed:

     [Unit]
     Description=AltServer Service
     Requires=docker.service
     After=docker.service
     
     [Service]
     Type=oneshot
     RemainAfterExit=yes
     WorkingDirectory=/path/to/your/docker-compose.yml
     ExecStart=/usr/local/bin/docker-compose up
     ExecStop=/usr/local/bin/docker-compose down
     
     [Install]
     WantedBy=multi-user.target

   • Enable and start the service

     sudo systemctl daemon-reload
     sudo systemctl enable altserver.service
     sudo systemctl start altserver.service

Software used in the docker image

• AltServer-Linux
• anisette-v3-server
• netmuxd
• avahi