FAQ

How can I upgrade from 1.x.x to 2.x.x?

The major release 2.0.0 is backwards incompatible with existing installations, since the migration scripts are manually altered (See commit) and the checksums in the metadata table of Flyway (our DB migration tool) need to be corrected. This can be done executing the following command:

mvn initialize flyway:repair

How can i run SteVe behind a reverse proxy?

You can easily run SteVe behind a reverse proxy by forwarding /steve/ to the respective host. The following configuration would work for NGINX:

location /steve/ {
    proxy_pass http://192.168.1.100/steve/;
}

Keep in mind that OCPP-J using WebSockets might require additional configuration or depending on your proxy software, wont work at all.

When to disable Gzip?

As default, gzip compression is enabled to return compressed content. But, if you are running SteVe behind a proxy (like nginx) that is already handling your compression, you should disable it in SteVe.

How to use with multiple interfaces?

If your server has multiple network interfaces, using 0.0.0.0 as the [server host] (https://github.com/RWTH-i5-IDSG/steve/blob/master/src/main/resources/config/prod/main.properties#L16) will make the application listen to all interfaces. But this might have security implications.