Current Release
Installing LANraragi
Basic Operations
Advanced Usage
Developer Guide
API Documentation
Docker (All platforms)
Docker is the best way to install the software on remote servers. I don't recommand it for Desktop machines and casual users due to it being a bit complex to wield.
A Docker image exists for deploying LANraragi installs to your machine easily without disrupting your already-existing web server setup.
Docker is the best way to install the software on remote servers. I don't recommand it for Desktop machines and casual users due to it being a bit complex to wield.
Cloning the base LRR image
1
docker run --name=lanraragi -p 3000:3000 \
2
--mount type=bind,source=[YOUR_CONTENT_DIRECTORY],target=/home/koyomi/lanraragi/content \
3
--mount type=bind,source=[YOUR_DATABASE_DIRECTORY],target=/home/koyomi/lanraragi/database \
4
difegue/lanraragi
Copied!
If your Docker version is below 17.06 and you use the --mount option as listed above, you will get the following error:
1
unknown flag: --mount
2
See 'docker run --help'.
Copied!
You can bypass this issue by using the --volume option for bind-mounting like so:
1
docker run --name=lanraragi -p 3000:3000 \
2
--volume [YOUR_CONTENT_DIRECTORY]:/home/koyomi/lanraragi/content \
3
--volume [YOUR_CONTENT_DIRECTORY]:/home/koyomi/lanraragi/database \
4
difegue/lanraragi
Copied!
You can tell Docker to auto-restart the LRR container on boot by adding the
--restart always flag to this command.Windows 7/8 users running the Legacy Docker toolbox will have to explicitly forward port 127.0.0.1:3000 from the host to the container in order to be able to access the app.
The content directory you have to specify in the command above will contain archives you either upload through the software or directly drop in, alongside generated thumbnails.
The database directory houses the LANraragi database(As database.rdb), allowing you to hotswap containers without losing any data.
You can also mount the database directory to a dedicated Docker volume:
1
docker volume create lrr-database
2
docker run --name=lanraragi -p 3000:3000 \
3
--mount type=bind,source=[YOUR_CONTENT_DIRECTORY],target=/home/koyomi/lanraragi/content \
4
--mount source=lrr-database,target=/home/koyomi/lanraragi/database \
5
difegue/lanraragi
Copied!
The volume can be reused when updating, so your database will still follow along even if the container is destroyed.
You can always backup the database using LANraragi's internal tool.
Once your LANraragi container is loaded, you can access it at http://localhost:3000 .
You can use the following commands to stop/start/remove the container(Removing it won't delete the archive directory you specified) :
1
docker stop lanraragi
2
docker start lanraragi
3
docker rm lanraragi
Copied!
​Tags exist for major releases, so you can use those if you want to run another version:
docker run [yadda yadda] difegue/lanraragi:0.4.0If you're feeling extra dangerous, you can run the last files directly from the dev branch of the Git repo through the nightly tag:
docker run [zoinks] difegue/lanraragi:nightlyChanging the port
Since Docker allows for port mapping, you can most of times map the default port of 3000 to another port on your host quickly.
If you need something a bit more involved (like adding SSL), please check the Network Interfaces section for how to use thhe
LRR_NETWORK environment variable.The default healthchecks of the Docker container base themselves on port 3000.
If you use the LRR_NETWORK variable to change the outgoing port instead of Docker's port mapping, said healthchecks will fail.
If you have to use the variable for SSL or the like, I recommend leaving the port in it to 3000 and doing your port mapping on the Docker side.
Changing the user ID in case of permission issues
The container runs the software by default using the uid/gid provided by the LRR_UID/LRR_GID variables.
If you don't specify said variables, the container will run under uid/gid 9001/9001.
This is good enough for most scenarios, but in case you need to run it as the current user, you can do the following:
docker run [wassup] -e LRR_UID=``id -u $USER`` -e LRR_GID=``id -g $USER`` difegue/lanraragiThis uses
id to automatically fetch your userid/groupid.Updating
As Docker containers are immutable, you need to destroy your existing container and build a new one.
1
docker pull difegue/lanraragi
2
docker stop lanraragi
3
docker rm lanraragi
4
docker run --name=lanraragi -p 3000:3000 --mount type=bind,source=[YOUR_CONTENT_DIRECTORY],target=/home/koyomi/lanraragi/content difegue/lanraragi
Copied!
As long as you use the same content directory as the mount source, your data will still be there.
If you update often, you might want to consider using docker-compose or Portainer to redeploy containers without entering the entire configuration every time.
Building your own
The previous setup gets a working LANraragi container from the Docker Hub, but you can build your own bleeding edge version by executing
npm run docker-build from a cloned Git repo.This will use your cloned Git repo to build the image, modifications you might have made included.
Of course, this requires a Docker installation.
If you're running WSL1, which can't run Docker natively, you can directly use the Docker for Windows executable with a simple symlink:
1
sudo ln -s '/mnt/c/Program Files/Docker/Docker/resources/bin/docker.exe' \
2
/usr/local/bin/docker
Copied!