Guide to using Archivy with Docker
This document contains enough information to help you get started with using Archivy as a container, in this case, with Docker(although you can use any other container runtime).
This document will cover the following:
- Prerequisites
-
Running Archivy- Via Docker-Compose
- Via Docker Run
- Application Setup
- Installing Plugins
NOTE: Parts of the document may be incomplete as it is a work in progress. In time, more information will be added to each section/topic. If some part of the documentation is ambiguous, feel free to ask questions or make suggestions on the Issues page of the project. If necessary, additional revisions to the documentation can be made based on user feedback.
Prerequisites
- Docker.
You can check if Docker is installed by running
$ docker --version Docker version 19.03.12, build 48a66213fe
If you don’t have Docker installed, take a look at theofficial installation guidefor your device.
- Docker-compose.
You can check if Docker-compose is installed by running
$ docker-compose --version docker-compose version 1.12.0, build unknown
If you don’t have Docker-compose installed, take a look at theofficial installation guidefor your device.
Setup
Docker-Compose
-
Download
docker-compose.ymlordocker-compose-light.ymlinto the folder you want to use for Archivy (something like~/docker/archivy). Edit the compose file as needed for your network (host, port…). The default compose file (docker-compose.yml) is setup with Elasticsearch whereas the other one is more lightweight, using ripgrep for search. Seeherefor more info on this. -
In the folder from which you will start docker-compose, create a directory for persistent storage of your notes:
mkdir ./archivy_data. -
(optional): Archivy has manyconfig optionsthat allow you to finetune its behavior. If you want to define your own configuration, instead of using thedefault ones we wrote for use with Docker, create an
archivy_configdirectory in the same directory asarchivy_data. We recommend you at least build off the defaults.
Note: If your user ID is anything other than 1000 (you can check with theidcommand), you will need to change the owner of these directories to the 1000 UID and 1000 GID. Example:chown -R 1000:1000 ./archivy_data.
- Start the docker-compose stack with:
docker-compose up -dordocker-compose up -d -f docker-compose-lite.ymlfor the lightweight option. If you’re using your custom configuration, add-f docker-compose.custom-config.ymlas an option to the preceding command.
Application Setup
You should now be able to access your Archivy installation atht服务器托管网tp://:5000where is the IP of the machine running your Docker environment.
However, the base installation has no users, so you will be unable to log in.
To create a new admin, run:
docker exec -it archivy archivy create-admin --password
-
docker exec -it archivytells Docker to execute a command on the archivy container with an interactive pseudo-TTY. Read morehere. -
archivy create-admin --passwordis the command run by docker which creates a new admin account with the password and username provided.
Congratulations! You can now log into your new Archivy instance (complete with search and pe服务器托管网rsistent data) with the credentials you created above. Happy archiving!
Installing Plugins
To install plugins into your Dockerized Archivy instance, you can simply runpipinside the container. For example:
docker exec archivy pip install archivy_gitto install thearchivy-gitplugin.
NOTE: Plugins will persist as long as the container’s system volume does. If you turn off your Archivy instancedocker-compose down, you will destroy the container’s system volume. Turning off your Archivy instance withdocker container stop archivywill not cause this issue.
Note: Some plugins will require dependencies installed into the container (e.g.archivy-hn). In such cases, follow the Docker installation instructions provided by the plugin maintainer. If none exist, open an issue.
服务器托管，北京服务器托管，服务器租用 http://www.fwqtg.net
