Install Realm Object Server
Realm’s package repositories are managed through a service called PackageCloud.
Run the following commands to set up the package repositories, then install and start Realm Object Server:
# Setup Realm's PackageCloud repository curl -s https://packagecloud.io/install/repositories/realm/realm/script.rpm.sh | sudo bash # Install the Realm Object Server sudo yum -y install realm-object-server-developer # Enable and start the service sudo chkconfig realm-object-server on sudo service realm-object-server start
# Setup Realm's PackageCloud repository curl -s https://packagecloud.io/install/repositories/realm/realm/script.rpm.sh | sudo bash # Install the Realm Object Server sudo yum -y install realm-object-server-developer # Enable and start the service sudo systemctl enable realm-object-server sudo systemctl start realm-object-server
# Setup Realm's PackageCloud repository curl -s https://packagecloud.io/install/repositories/realm/realm/script.deb.sh | sudo bash # Update the repositories sudo apt-get update # Install the Realm Object Server sudo apt-get install realm-object-server-developer # Enable and start the service sudo systemctl enable realm-object-server sudo systemctl start realm-object-server
We also provide public AMIs for Amazon EC2, based on Ubuntu 16.04. For details on the difference between Paravirtual and HVM see this guide.
|ap-northeast-1 (Tokyo)|| || |
|eu-west-1 (Ireland)|| || |
|us-east-1 (N. Virginia)|| || |
You can launch these AMIs just as any other Amazon EC2 AMI. Make sure you open port
22/TCP (ssh) and
9080/TCP (dashboard and client access). The default SSH user is
Setting Up the Realm Dashboard
You will need access to a web browser either on the local Linux machine, or remotely over the network. If you are using a remote browser, you will need to know the network IP address or hostname of the server you just installed ROS on. Replace
localhost with the appropriate IP address or hostname in the URL below.
Open a new browser window and go to http://localhost:9080. The login page for the Realm Dashboard will be displayed. If your Linux server is not your local machine, replace
localhost with the IP address of your server.
Create an admin user by entering your email and password. After registering, you can log in using these credentials.
The Realm Dashboard will show you the status of the Realm Object Server, including active network connections, active Realms, and the amount of network traffic being generated by connected apps.
Check firewall rules for external access to the Realm Dashboard
Certain factors may impact external (non-
localhost) access to the Realm Object Server’s synchronization facility, and the Realm Dashboard. In order to enable access to the dashboard, it may be necessary to open port 9080 on your server(s).
Using the standard Linux tools, these commands will open access to the port:
sudo iptables -A INPUT -p tcp -m tcp --dport 9080 -j ACCEPT sudo service iptables save
Please refer to the CentOS 6 Documentation for more information regarding how to configure your firewall.
sudo firewall-cmd --get-active-zones sudo firewall-cmd --zone=public --add-port=9080/tcp --permanent sudo firewall-cmd --reload
sudo ufw allow 9080/tcp sudo ufw reload
If your environment does not use your distribution’s standard firewall, you will have to modify these instructions to fit your environment.
Get the source code from GitHub. If you’re building for iOS or Android, you can follow one of our tutorials:
Tutorials for React Native and Xamarin are coming soon; in the meantime, you can download and build the app on your own.
If you have a Mac, you can get a local installation of the Realm Object Server and RealmTasks for macOS precompiled with the macOS bundle.
If you’ve never used the Realm Mobile Database before, you might want to start by picking your platform and checking the docs. There, you’ll learn about what makes our database unique, like the power of live objects, auto-updating queries, and the freedom from ever having to use an ORM again. Or, you can follow a tutorial to build an iOS app similar to RealmTasks from scratch.
If you’re more familiar with the Realm Mobile Platform (or you came here from the Realm Object Server installation page), then jump right into the Realm Object Server documentation documentation.