Setup guide

Note: This guide assumes that you already have

• a java webserver (examples assume Tomcat 8.5)
• a SQL server (examples assume MySQL 5.7)

set up.

Setup database

1. Create a new database in your SQL server (Name it e.g. acra)
2. Create a new user in your SQL server (Name e.g. acra. remember its password, we'll need it later)
3. Restrict the users access to the newly created database (Optional but recommended)

Setup configuration

1. Find the home directory of the user running the webserver (e.g. getent passwd tomcat8 returns usr/share/tomcat8 as home directory of my tomcat8 user)
2. Create a folder named .acra in this directory (e.g. /usr/share/tomcat8/.acra)
3. Create a file named application.properties in that directory (e.g. /usr/share/tomcat8/.acra/application.properties)
4. Add the following lines in that file and adjust them to your setup:

# spring.datasource.url=jdbc:mysql://<sql host>:<sql port>/<database name>?useSSL=false, e.g.
spring.datasource.url=jdbc:mysql://localhost:3306/acra?useSSL=false
# spring.datasource.username=<sql user name>, e.g.
spring.datasource.username=acra
# spring.datasource.password=<sql user password>, e.g.
spring.datasource.password=password1234
# spring.jpa.database-platform=<sql dialect>, available dialects https://docs.jboss.org/hibernate/orm/5.2/javadocs/org/hibernate/dialect/package-summary.html, e.g.
spring.jpa.database-platform=org.hibernate.dialect.MySQL57Dialect
# acra.user.name=<default user name>, optional but recommended, e.g.
acra.user.name=admin
# acra.user.password=<default user password>, optional but recommended, e.g.
acra.user.password=admin

Setup Web application

1. Download the latest release
2. Deploy it to your java web server

Create an application

1. Open the deployed application in any web browser
2. Log in with the default user credentials you set above
3. Click on "New App" and follow the instructions
4. In the end you'll be presented with an ACRA configuration which you should paste into your android project