keyoxide-web/content/guides/self-hosting-keyoxide.md

Self-hosting Keyoxide

Self-hosting Keyoxide is an important aspect of the project. Users need to trust the Keyoxide instance they're using to reliably verify identities. Making Keyoxide itself decentralized means no one needs to trust a central server. If a friend or family member is hosting a Keyoxide instance, it becomes much easier to trust the instance!

Docker

• Run docker run -d -p 3000:3000 keyoxide/keyoxide:stable

Configuration

• Add environment variables to the docker command:
  docker run -d -p 3000:3000 -e PROXY_HOSTNAME=proxy.domain.tld keyoxide/keyoxide:stable

Without Docker

• Fetch the source code and put the files on your server
• Run yarn or npm install to install the dependencies
• Run yarn run start or npm run start to start the server at http://localhost:3000
• Point your reverse proxy to http://localhost:3000

Configuration

• Add a .env file to the root directory of the source code:

# .env file

# Enable the use of a proxy (replace with your proxy server domain)
PROXY_HOSTNAME=proxy.domain.tld