The Eludris CLI
The Eludris CLI is a tool that’s meant to handle all the heavy lifting that comes with initially starting an Eludris instance and managing it until the end of time.
Installation
You can install the Eludris CLI in a couple of ways, mainly you can either:
- Install it from the releases page.
- Install it using Cargo.
cargo install eludris - Install it from the AUR on Arch based Linux distributions:
<your preferred aur helper> -S eludris
You can also clone the repository and build it from source.
Usage
If you need any help with using the Eludris CLI at any time you should always check
the help command by running eludris --help. This will almost always tell you what
you want to know.
Upon using the CLI for the first time you will get prompted for some config questions
namely about where to put the Eludris instance.
This can be changed at any time by editing the config file found in ~/.config/eludris/Cli.toml
Commands
Here’s a list of the commands the Eludris CLI has along with a few extra notes.
Deploy
eludris deploy [--next]This command will start up your Eludris instance using our pre-built Docker images.
Additionally if no instance is already found on your machine it will take you on a step by step process to create one in your configured Eludris directory.
Using the --next flag will make you use the latest development version of Eludris
for your instance instead.
Note
When prompted to choose an editor do not chose VSCode or any of it’s forks as this command is ran as root which will really mess up your root partition.
Although you can still pass in a full command to use it you have been warned.
Stop
eludris stopThis command will stop all the microservices in your instance along with all the other databases and such.
Update
eludris update [--next]This command will update your instance’s version of Eludris to the latest available version on GitHub.
Using the --next flag makes you update to the latest development version of ELudris.
Logs
eludris logsThis command will show you your instance’s logs and wait for new ones.
Static
This is a command group which is meant to help deal with static assets.
Add
eludris static add <path-to-file>This command will add a new static asset to your instance’s Effis.
Remove
eludris static remove <name>This command will remove a static asset from your instance’s Effis.
Attachments
This is a command group which is meant to help deal with Effis files in the attachments bucket.
Remove
eludris attachments remove <id>This command will remove an attachment’s file from your instance along with its
database entry to prevent 500 errors.
Clean
eludris cleanThis command will remove your Eludris instance along with all the database files.
Note
This will not clean up the docker images, you can remove those using
docker image rm <image names>*