Cloud
& iPad

Setting up the DocMoto server to support iPad Files integration

The iPad Files app integration requires two settings:

  1. DocMoto server to use a verified SSL certificate
  2. Opening port 4984

DocMoto server to use a verified SSL certificate

By default a DocMoto server uses a self signed SSL certificate. This is great for most circumstances, but for the iPad (and any other third party apps) to connect smoothly you need to configure the DocMoto server to use a verified valid SSL certificate.

Obtaining a verified SSL certificate is outside of the scope of this article. However once you have your certificate you will need it in the pem format (ie my cert file.pem).

The procedure for configuring your DocMoto server to use your verified certificate is as follows:

  1. Open terminal and switch to super user by typing
    sudo -s
  2. Move to the settings folder by typing
    cd /var/opt/docmoto/settings
  3. Rename the existing self signed certificate by typing
    mv DocMoto.pem DocMoto.pem.org
  4. Copy the new pem file to the settings folder by typing
    cp <the full path to my pem>.pem .
  5. Change the ownership of the pem file to user DocMoto by typing
    chown docmoto <my pem file>.pem
  6. Edit the serverConfig.conf to ensure the default secure port 3984 uses the new certificate ie
    <Https
         port="3984"
         pem-filename="<path to my certificate file>.pem">
         <WebDav />
         <Admin />
    </Https>
  7. Restart the DocMoto server by going into System Preferences, finding DocMoto Server, and restarting.

Opening port 4984

Firstly you must open port 4984 on your network router. Without this external connections will be blocked.

Consult your router documentation on how to open up port 4984 and ensure that traffic is directed to the DocMoto server.

Secondly you must check that your DocMoto server is listening on port 4984. Do this as follows:

  • Open terminal and switch to super user by typing
    sudo -s
  • Move to the settings folder by typing
    cd /var/opt/docmoto/settings
  • Open the serverConfig.config file by typing
    less serverConfig.config
    and look for the following entry
    <Https
        port="4984"
        pem-filename="<path to my certificate file>.pem">
        <WebDav />
        <Admin />
        <AutoVersioning/>
    </Https>
    
    where the pem-filename points to the pem file copied in the steps above.
  • If you do not have this entry then you will need to edit the serverConfig.config file using an editor such as vi or nano.
  • Once edited your full serverConfig.conf https section should look as follows:
    <Https
        port="3984"
        pem-filename="<path to my certificate file>.pem">
        <WebDav />
        <Admin />
    </Https>
    <!-- Ports that do autoversioning... useful to use with WebDAV clients that don't do DeltaV -->
    <Https
        port="4984"
        pem-filename="<path to my certificate file>.pem">
        <WebDav />
        <Admin />
        <AutoVersioning/>
    </Https>
  • Restart the DocMoto server by going into System Preferences, finding DocMoto Server, and restarting.

Still have a question?

If you still can't find the answer to your question or need more information, please contact the DocMoto team on +44 (0)1242 225230 or email us

We value your privacy

We use Cookies to make using our website easy and meaningful for you, and to better understand how it is used by our customers. By using our website, you are agreeing to our privacy policy.

I agree