Altserver-docker

A dockerized version of AltServer-Linux with Wi-Fi sync capability.

Run the server

docker compose

To start up the application, run the docker-compose stack:

docker compose up -d --build

Using docker run

Just run run.sh, or manually in your terminal:

docker build . -t altserver-docker && \
docker stop altserver || true && \
docker rm altserver || true && \
sudo docker run -d \
  -v "./lib:/root/.config/Provision/lib" \
  -v "./logs:/altserver/logs" \
  -v "./bin:/altserver/bin" \
  -v "/dev/bus/usb:/dev/bus/usb" \
  -v "/var/lib/lockdown:/var/lib/lockdown" \
  -v "/var/run:/var/run" \
  -v "/sys/fs/cgroup:/sys/fs/cgroup:ro" \
  --name altserver \
  --network host \
  --privileged \
  altserver-docker 

Logs

Logs will be stored in the directory where the container is ran inside ./logs

Provision libraries

Provision automatically pulls the libraries it requires (libCoreADI.so and libstoreservicescore.so) from the apple music android apk, but this requires a 60+MB download it does automatically, so I decided to include these in the root of the repo already and have the docker-entrypoint.sh decompress them where Provision normally would. This is optional and can be removed/commented from the docker-entrypoint.sh if you prefer to have Provision download and pull them from the apk.

Updating lib.tar.xz

To update lib.tar.xz just run:

bash scripts/provision-deps-manual-download.sh

from the root of the repo.

Credits

I authored this repo but I did NOT author the projects it depends on. In particular:

• AltServer-Linux
• netmuxd
• Provision
• Altstore

And some other projects which inspired me to create this repo:

• altserverd which I took inspiration and some code from.
• AltServer-Linux-PyScript which I audited and took inspiration from.

Contributing

Feel free to open an issue or a PR if you have any suggestions or improvements to this repo. I'm always open to feedback and contributions!