Skip to content

Instantly share code, notes, and snippets.

@DaGeRe
Created September 5, 2025 13:24
Show Gist options
  • Select an option

  • Save DaGeRe/1b22f4f725228ef231b7de6568ef5484 to your computer and use it in GitHub Desktop.

Select an option

Save DaGeRe/1b22f4f725228ef231b7de6568ef5484 to your computer and use it in GitHub Desktop.
To start Valetudo locally (with a mocked robot), execute the following commands:
1. Clone and build the backend
```
git clone git@github.com:Hypfer/Valetudo.git
cd Valetudo/
npm install
npm run start:dev --workspace=backend
```
This create a draft of the config. Change the first lines in ./local/valetudo_config.json to
```
{
"embedded": true,
"robot": {
"implementation": "MockRobot",
"implementationSpecificConfig": {}
},
"webserver": {
"port": 8080,
"basicAuth": {
"enabled": false,
"username": "valetudo",
"password": "valetudo"
},
"blockExternalAccess": true
},
```
(you'll need port 8080 to be allowed to start something listening for the port, and the MockRobot makes it possible to run it locally without having a real robot connected)
2. Start the backend (and leave this terminal open):
```
npm run start:dev --workspace=backend
```
3. Start the frontend (in a separate terminal):
```
cd frontend && npm run watch
```
Now you can access Valetudo in your browser using http://localhost:8080
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment