# Hosting FarmOS for Dummies

**URL:** <https://farmos.discourse.group/t/hosting-farmos-for-dummies/978>\
**Category:** Hosting farmOS\
**Created:** [November 12, 2021, 1:41pm UTC](https://farmos.discourse.group/t/hosting-farmos-for-dummies/978 "2021-11-12T13:41:02Z")\
**Posts on this page:** 20\
**Page:** 1

<div class="post-metadata">

**Author:** ![erdwurmboer](https://avatars.discourse-cdn.com/v4/letter/e/a9adbd/32.png) [@erdwurmboer](https://farmos.discourse.group/u/erdwurmboer)\
**Post date:** [November 12, 2021, 1:41pm UTC](https://farmos.discourse.group/t/hosting-farmos-for-dummies/978/1 "2021-11-12T13:41:03Z")

</div>

Hi, I want to install FarmOS on a webserver using cpanel. A few questions:

1. Would I first need to install Drupal and then farmOS afterwards? I am not quite clued up with the backend of hosting.
2. I can’t seem to find the “Hosting FarmOS for Dummies” (so to speak)… Could someone point me in the right direction where to find the easiest information about loading FarmOS onto a webserver?
3. If I have a registered domain and hosting for example: mydomain.xx, could I install FarmOS on that domain? ( I will then make this domain private so that only I can access it)

---

<div class="post-metadata">

**Author:** ![mstenta](https://yyz2.discourse-cdn.com/free1/user_avatar/farmos.discourse.group/mstenta/32/4_2.png) [@mstenta](https://farmos.discourse.group/u/mstenta)\
**Post date:** [November 12, 2021, 2:42pm UTC](https://farmos.discourse.group/t/hosting-farmos-for-dummies/978/2 "2021-11-12T14:42:41Z")

</div>

Hi @erdwurmboer - welcome to the farmOS community!

I haven’t hosted farmOS on a CPanel setup, so I can’t speak to it myself, but I think others have.

> Would I first need to install Drupal and then farmOS afterwards?

No - farmOS includes Drupal with it, so you just need to download the packaged zip/tarball and unpack it in your server’s webroot.

It’s important to always use the packaged releases, because farmOS includes some patches to Drupal core and other contrib modules that won’t be there if you download the pieces separately.

> where to find the easiest information about loading FarmOS onto a webserver?

The current “stable” version of farmOS is 7.x-1.7 (version 1.7 for Drupal 7). The 7.x-1.7 packaged release is available here: [https://www.drupal.org/project/farm/releases/7.x-1.7](https://www.drupal.org/project/farm/releases/7.x-1.7) - and hosting/installation instructions are here: [https://farmos.org/hosting/installing/](https://farmos.org/hosting/installing/)

We are currently working on the new 2.x version of farmOS, however, and if you are just getting started you may want to try that instead, so you don’t have to worry about upgrading from 1.x-\>2.x in the future, which is a bit complicated.

The current version of farmOS 2.x is 2.0.0-alpha5 (we are very close to tagging the first “beta” release, but generally speaking it is stable and not much is going to change before then). The packaged release is available for download here: [Release 2.0.0-alpha5 · farmOS/farmOS · GitHub](https://github.com/farmOS/farmOS/releases/tag/2.0.0-alpha5) - and the 2.x hosting/installation instructions are here: [Installing farmOS | farmOS](https://docs.farmos.org/hosting/install/) - that said, you will be an “early adopter” if you start with 2.x, so hopefully you’re up for reporting bugs etc. 😉

There are currently two recommended approaches to hosting farmOS 2.x: 1) Docker and 2) Packaged releases. You will want to the “packaged release” approach, as I described above. Docs for that specifically are here: [Installing farmOS | farmOS](https://docs.farmos.org/hosting/install/#packaged-releases)

And when it comes time to update to a new version (assuming you start with 2.0.0-alpha5), docs for updating packaged releases are here: [Updating farmOS | farmOS](https://docs.farmos.org/hosting/update/#updating-via-packaged-releases)

Make sure you read through all those docs thoroughly to understand the considerations and requirements. The Docker images pre-package all the server dependencies, but the packaged releases assume that your hosting server has everything, so your mileage may vary depending on your host.

> If I have a registered domain and hosting for example: mydomain.xx, could I install FarmOS on that domain?

Sure! farmOS works just like a website (eg: Drupal, Wordpress, etc). You just need to put the code in your server’s webroot, and point your domain name at that.

I would also recommend setting up SSL certificates, if your host has support for that.

And of course… shameless plug: I provide “farmOS-as-a-service” hosting through [Farmier.com](http://Farmier.com), if you would rather have someone else take care of the hosting stuff.

Either way, good luck, welcome to the community, and feel free to ask questions! 🙂

---

<div class="post-metadata">

**Author:** ![erdwurmboer](https://avatars.discourse-cdn.com/v4/letter/e/a9adbd/32.png) [@erdwurmboer](https://farmos.discourse.group/u/erdwurmboer)\
**Post date:** [November 12, 2021, 3:29pm UTC](https://farmos.discourse.group/t/hosting-farmos-for-dummies/978/3 "2021-11-12T15:29:07Z")

</div>

Thanks for the detailed Reply.Maybe I should have a trial run on [farmier.com](http://farmier.com) and see if it works for me? Could I later transfer my data from Farmier to my own server?

---

<div class="post-metadata">

**Author:** ![erdwurmboer](https://avatars.discourse-cdn.com/v4/letter/e/a9adbd/32.png) [@erdwurmboer](https://farmos.discourse.group/u/erdwurmboer)\
**Post date:** [November 13, 2021, 11:40am UTC](https://farmos.discourse.group/t/hosting-farmos-for-dummies/978/4 "2021-11-13T11:40:16Z")

</div>

HI,

I’ve managed to unzip the farmOS 2.x is 2.0.0-alpha5 package into my domain root directory. When visit the url, i found a “Web” link, that took me to the install page. It asked me about my language. I selected English. It then want to configure the Database (which I created before hand). I entered the name and username and password associated with it. The clicked “save and continue”, but I only get a blank screen.When I refreshed after a while, I get a message farmOS 2.0.0-alpha5

## Drupal already installed

- To start over, you must empty your existing database and copy _default.settings.php_ over _settings.php_ .
- To upgrade an existing installation, proceed to the [update script]
- View your [existing site]

When I go to “existing site”, this message appears: The website encountered an unexpected error. Please try again later."

Is this a problem with the FarmOs2.x package? Or am I doing something wrong?

---

<div class="post-metadata">

**Author:** ![mstenta](https://yyz2.discourse-cdn.com/free1/user_avatar/farmos.discourse.group/mstenta/32/4_2.png) [@mstenta](https://farmos.discourse.group/u/mstenta)\
**Post date:** [November 13, 2021, 1:19pm UTC](https://farmos.discourse.group/t/hosting-farmos-for-dummies/978/5 "2021-11-13T13:19:34Z")

</div>

> I entered the name and username and password associated with it. The clicked “save and continue”, but I only get a blank screen.

Hmm - sounds like a PHP error occurred (sometimes results in a blank screen like this). Do you have access to your server’s Apache logs to see what the error was? That will help debugging.

FYI we host a weekly dev call if you want to try figuring this out together: [farmOS Community Calls](https://farmos.discourse.group/t/farmos-community-calls/972)

We also have a chat room - feel free to post questions there and I (or others) can respond live (or when we’re available): [https://app.element.io/#/room/#farmOS:matrix.org](https://app.element.io/#/room/#farmOS:matrix.org)

---

<div class="post-metadata">

**Author:** ![erdwurmboer](https://avatars.discourse-cdn.com/v4/letter/e/a9adbd/32.png) [@erdwurmboer](https://farmos.discourse.group/u/erdwurmboer)\
**Post date:** [November 13, 2021, 1:47pm UTC](https://farmos.discourse.group/t/hosting-farmos-for-dummies/978/6 "2021-11-13T13:47:55Z")

</div>

It was a small error on my side. The hosting company helped me fix it. And farmOS 2.x is 2.0.0-alpha5 is up and running! Wasn’t too difficult after all…

---

<div class="post-metadata">

**Author:** ![oliverp44](https://avatars.discourse-cdn.com/v4/letter/o/d26b3c/32.png) [@oliverp44](https://farmos.discourse.group/u/oliverp44)\
**Post date:** [December 15, 2021, 9:44am UTC](https://farmos.discourse.group/t/hosting-farmos-for-dummies/978/7 "2021-12-15T09:44:40Z")

</div>

Hi, I have started to install version 2 (new user). Install was going well (using the above instructions) until the end where I got the following error - I wonder if you can let me know how to resolve the issue ?

An AJAX HTTP error occurred.  
HTTP Result Code: 200  
Debugging information follows.  
Path: /farmOS/web/core/install.php?rewrite=ok&profile=farm&langcode=en&id=2&op=do\_nojs&op=do  
StatusText: OK  
ResponseText: ParseError: syntax error, unexpected ‘LogLocationInterface’ (T\_STRING), expecting function (T\_FUNCTION) or const (T\_CONST) in Composer\Autoload\includeFile() (line 25 of /chroot/home/aea97723/868baac267.nxcli.net/html/farmOS/web/profiles/farm/modules/core/location/src/EventSubscriber/LogEventSubscriber.php).

Additional uncaught exception thrown while handling exception.  
Original  
ParseError: syntax error, unexpected ‘LogLocationInterface’ (T\_STRING), expecting function (T\_FUNCTION) or const (T\_CONST) in Composer\Autoload\includeFile() (line 25 of /chroot/home/aea97723/868baac267.nxcli.net/html/farmOS/web/profiles/farm/modules/core/location/src/EventSubscriber/LogEventSubscriber.php).

Composer\Autoload\includeFile(’/chroot/home/aea97723/868baac267.nxcli.net/html/farmOS/web/profiles/farm/modules/core/location/src/EventSubscriber/LogEventSubscriber.php’) (Line: 428)  
Composer\Autoload\ClassLoader-\>loadClass(‘Drupal\farm\_location\EventSubscriber\LogEventSubscriber’)  
spl\_autoload\_call(‘Drupal\farm\_location\EventSubscriber\LogEventSubscriber’)  
ReflectionClass-\>\_\_construct(‘Drupal\farm\_location\EventSubscriber\LogEventSubscriber’) (Line: 30)  
Drupal\Core\DependencyInjection\Compiler\RegisterEventSubscribersPass-\>process(Object) (Line: 94)  
Symfony\Component\DependencyInjection\Compiler\Compiler-\>compile(Object) (Line: 762)  
Symfony\Component\DependencyInjection\ContainerBuilder-\>compile() (Line: 1304)  
Drupal\Core\DrupalKernel-\>compileContainer() (Line: 909)  
Drupal\Core\DrupalKernel-\>initializeContainer() (Line: 20)  
Drupal\Core\Installer\InstallerKernel-\>initializeContainer() (Line: 473)  
Drupal\Core\DrupalKernel-\>boot() (Line: 425)  
install\_begin\_request(Object, Array) (Line: 115)  
install\_drupal(Object) (Line: 48)  
Additional  
Symfony\Component\DependencyInjection\Exception\ServiceNotFoundException: You have requested a non-existent service “theme.manager”. in Symfony\Component\DependencyInjection\ContainerBuilder-\>getDefinition() (line 1030 of /chroot/home/aea97723/868baac267.nxcli.net/html/farmOS/vendor/symfony/dependency-injection/ContainerBuilder.php).

Symfony\Component\DependencyInjection\ContainerBuilder-\>getDefinition(‘theme.manager’) (Line: 600)  
Symfony\Component\DependencyInjection\ContainerBuilder-\>doGet(‘theme.manager’, 1) (Line: 558)  
Symfony\Component\DependencyInjection\ContainerBuilder-\>get(‘theme.manager’) (Line: 650)  
Drupal::theme() (Line: 22)  
\_drupal\_maintenance\_theme() (Line: 471)  
drupal\_maintenance\_theme() (Line: 1019)  
install\_display\_output(Array, Array) (Line: 271)  
\_drupal\_log\_error(Array, 1) (Line: 330)  
\_drupal\_exception\_handler(Object)

---

<div class="post-metadata">

**Author:** ![mstenta](https://yyz2.discourse-cdn.com/free1/user_avatar/farmos.discourse.group/mstenta/32/4_2.png) [@mstenta](https://farmos.discourse.group/u/mstenta)\
**Post date:** [December 15, 2021, 12:31pm UTC](https://farmos.discourse.group/t/hosting-farmos-for-dummies/978/8 "2021-12-15T12:31:56Z")

</div>

Hi @oliverp44 - welcome to the forum!

Hmm I haven’t encountered these errors before myself. Can you tell me a bit more about your environment and the steps you followed specifically?

Are you using Docker ([described here](https://docs.farmos.org/hosting/install/#farmos-in-docker)) or packaged release ([described here](https://docs.farmos.org/hosting/install/#packaged-releases))?

If you are using packaged release, what environment are you hosting in? Linux? What Apache/PHP version?

Or are you using the development environment setup instructions? ([described here](https://docs.farmos.org/development/environment/))

Any additional info you can provide would be helpful.

---

<div class="post-metadata">

**Author:** ![oliverp44](https://avatars.discourse-cdn.com/v4/letter/o/d26b3c/32.png) [@oliverp44](https://farmos.discourse.group/u/oliverp44)\
**Post date:** [December 15, 2021, 12:47pm UTC](https://farmos.discourse.group/t/hosting-farmos-for-dummies/978/9 "2021-12-15T12:47:32Z")

</div>

Thanks for coming back to me.  
I am using Linux, php version 7.3 and trying the packaged release. I have tried it both with Drupal previously installed, then all files removed and also without having started with Drupal. When I set it up first with Drupal the Drupal site works fine (I then delete the html folder and its contents and create a new one). I am using a fresh / empty mysql database both time I have tried it…  
I get all the information where it wants to gather information about db details and user etc but it fails when it starts to do the install.

I have tried it twice using the farmOS-2.0.0-alpha5.tar.gz file.

The main error which occurs when it fails is

An AJAX HTTP error occurred.  
HTTP Result Code: 200  
Debugging information follows.  
Path: /farmOS/web/core/install.php?rewrite=ok&profile=farm&langcode=en&id=2&op=do\_nojs&op=do  
StatusText: OK  
ResponseText: ParseError: syntax error, unexpected ‘LogLocationInterface’ (T\_STRING), expecting function (T\_FUNCTION) or const (T\_CONST) in Composer\Autoload\includeFile() (line 25 of /chroot/home/aea97723/10b6712329.nxcli.net/html/farmOS/web/profiles/farm/modules/core/location/src/EventSubscriber/LogEventSubscriber.php).

---

<div class="post-metadata">

**Author:** ![mstenta](https://yyz2.discourse-cdn.com/free1/user_avatar/farmos.discourse.group/mstenta/32/4_2.png) [@mstenta](https://farmos.discourse.group/u/mstenta)\
**Post date:** [December 15, 2021, 1:10pm UTC](https://farmos.discourse.group/t/hosting-farmos-for-dummies/978/10 "2021-12-15T13:10:05Z")

</div>

> [@oliverp44](#):
>
> I am using Linux, php version 7.3 and trying the packaged release

Ah I think farmOS requires PHP 7.4+ - we should update the web server requirements doc ([here](https://docs.farmos.org/hosting/install/#web-server)). Can you try updating your PHP version and see if that helps?

Would you like to update the docs and contribute that back as well? The relevant file to edit is here: [https://github.com/farmOS/farmOS/blob/2.x/docs/hosting/install.md](https://github.com/farmOS/farmOS/blob/2.x/docs/hosting/install.md)

---

<div class="post-metadata">

**Author:** ![mstenta](https://yyz2.discourse-cdn.com/free1/user_avatar/farmos.discourse.group/mstenta/32/4_2.png) [@mstenta](https://farmos.discourse.group/u/mstenta)\
**Post date:** [December 15, 2021, 1:14pm UTC](https://farmos.discourse.group/t/hosting-farmos-for-dummies/978/11 "2021-12-15T13:14:27Z")

</div>

More details: farmOS code makes use of “typed properties”, which were introduced in PHP 7.4.

[https://www.php.net/manual/en/migration74.new-features.php#migration74.new-features.core.typed-properties](https://www.php.net/manual/en/migration74.new-features.php#migration74.new-features.core.typed-properties)

> <https://stackoverflow.com/questions/65242812/syntax-error-unexpected-request-t-string-expecting-function-t-function-o>

For what it’s worth, PHP 7.x is no longer [supported](https://www.php.net/supported-versions.php) (7.4 will receive security updates until November 2022, but no new feature development). We have an [issue](https://www.drupal.org/project/farm/issues/3186530) open for farmOS to start using PHP 8. So if at all possible you may want to just make the jump to PHP 8 right now.

Or use the farmOS Docker image, which will always have a compatible PHP version included.

---

<div class="post-metadata">

**Author:** ![oliverp44](https://avatars.discourse-cdn.com/v4/letter/o/d26b3c/32.png) [@oliverp44](https://farmos.discourse.group/u/oliverp44)\
**Post date:** [December 15, 2021, 2:13pm UTC](https://farmos.discourse.group/t/hosting-farmos-for-dummies/978/12 "2021-12-15T14:13:46Z")

</div>

Mike,

Thank you – that has solved the problem and it seems to have installed correctly.

I will take a look at the docs etc in due course however my main site does not like 7.4 so need to resolve that first !!

Out of interest is there the ability to print areas (ie agricultural fields) in this version. I found with my last system I could do that which was useful for showing a ploughman etc exactly where they were going and what to do ?

As I am only just getting going I will need to play with this version but it looks fantastic.

Thank you

Oliver

---

<div class="post-metadata">

**Author:** ![mstenta](https://yyz2.discourse-cdn.com/free1/user_avatar/farmos.discourse.group/mstenta/32/4_2.png) [@mstenta](https://farmos.discourse.group/u/mstenta)\
**Post date:** [December 15, 2021, 4:12pm UTC](https://farmos.discourse.group/t/hosting-farmos-for-dummies/978/13 "2021-12-15T16:12:32Z")

</div>

Excellent! Glad to hear that fixed it @oliverp44. 🙂

> is there the ability to print areas (ie agricultural fields) in this version

I haven’t tried it myself, but you may be able to just print a page with a map on it directly. I’d be curious how well that works in the new version. Give it a try and let us know!

---

<div class="post-metadata">

**Author:** ![Symbioquine](https://yyz2.discourse-cdn.com/free1/user_avatar/farmos.discourse.group/symbioquine/32/284_2.png) [@Symbioquine](https://farmos.discourse.group/u/Symbioquine)\
**Post date:** [December 15, 2021, 4:49pm UTC](https://farmos.discourse.group/t/hosting-farmos-for-dummies/978/14 "2021-12-15T16:49:35Z")

</div>

For advanced map printing use-cases, [farmOS\_wfs](https://github.com/symbioquine/farmOS_wfs) _(Please excuse the shameless plug - as I am the author of the farmOS\_wfs contrib module)_ could be used to allow QGIS (or similar GIS software) to connect to farmOS. QGIS could then be used to create professional quality printable maps containing your farmOS assets via its [Print Layout functionality](https://docs.qgis.org/3.4/en/docs/training_manual/map_composer/map_composer.html).

 ![image](https://global.discourse-cdn.com/free1/uploads/farm_os/original/1X/e476542ad3b711eef35b3d54e53edf7a4a676d5b.png)

---

<div class="post-metadata">

**Author:** ![oliverp44](https://avatars.discourse-cdn.com/v4/letter/o/d26b3c/32.png) [@oliverp44](https://farmos.discourse.group/u/oliverp44)\
**Post date:** [December 15, 2021, 9:58pm UTC](https://farmos.discourse.group/t/hosting-farmos-for-dummies/978/15 "2021-12-15T21:58:15Z")

</div>

Thank you - will take a look at the wfs module once the rest us up and running

---

<div class="post-metadata">

**Author:** ![oliverp44](https://avatars.discourse-cdn.com/v4/letter/o/d26b3c/32.png) [@oliverp44](https://farmos.discourse.group/u/oliverp44)\
**Post date:** [December 20, 2021, 6:41am UTC](https://farmos.discourse.group/t/hosting-farmos-for-dummies/978/16 "2021-12-20T06:41:59Z")

</div>

Mike

I am now getting up and running but couple of issues.

None of my locations show up in the dashboard map, even when they are selected in the layers to view panel. I have tried selecting / de selecting them, adding different location assets, and viewing in safari and edge.

Also I can’t see where I can activate google maps from. In the settings I have set up mapbox and entered its api and that works fine. But no sign of where I can enter google info.

![](https://global.discourse-cdn.com/free1/uploads/farm_os/original/1X/8b2591c339b48330a77b75757509b5f292fdf771.jpeg)

---

<div class="post-metadata">

**Author:** ![mstenta](https://yyz2.discourse-cdn.com/free1/user_avatar/farmos.discourse.group/mstenta/32/4_2.png) [@mstenta](https://farmos.discourse.group/u/mstenta)\
**Post date:** [December 20, 2021, 2:09pm UTC](https://farmos.discourse.group/t/hosting-farmos-for-dummies/978/17 "2021-12-20T14:09:34Z")

</div>

Hi @oliverp44

> None of my locations show up in the dashboard map

Do they show up in `/assets`? Do they appear in the list in `/locations`? Are they “archived” perhaps? Is the “Location” checkbox checked when you edit them? These are all the things I would check first…

> I can’t see where I can activate google maps from

Google Maps layers are not included with farmOS core anymore because they are somewhat buggy (Google’s fault, not ours). Instead we split them out to a “contrib” module that you have the option to download and install if you want to use them anyway: [https://www.drupal.org/project/farm\_map\_google](https://www.drupal.org/project/farm_map_google)

---

<div class="post-metadata">

**Author:** ![oliverp44](https://avatars.discourse-cdn.com/v4/letter/o/d26b3c/32.png) [@oliverp44](https://farmos.discourse.group/u/oliverp44)\
**Post date:** [December 20, 2021, 2:30pm UTC](https://farmos.discourse.group/t/hosting-farmos-for-dummies/978/18 "2021-12-20T14:30:13Z")

</div>

Thanks Mike,

Yes the locations all show up in assets, and they also show the polygons / lines etc as you would expect. It is only when you look at one of the summary pages where you should see any of the layers selected that they do not show at all. I have tried with different areas such as water as well but they still don’t show. Screen shot below shows the layers are selected and assets below which should show. These areas I imported as KLM file but I did create one new prior to the import and it does not show either.

 ![image](https://global.discourse-cdn.com/free1/uploads/farm_os/original/1X/027132cef57bedd6d6a985dbc75325a2a8129118.jpeg)

---

<div class="post-metadata">

**Author:** ![mstenta](https://yyz2.discourse-cdn.com/free1/user_avatar/farmos.discourse.group/mstenta/32/4_2.png) [@mstenta](https://farmos.discourse.group/u/mstenta)\
**Post date:** [December 20, 2021, 2:43pm UTC](https://farmos.discourse.group/t/hosting-farmos-for-dummies/978/19 "2021-12-20T14:43:24Z")

</div>

Can you check these as well…

> [@mstenta](#):
>
> Do they appear in the list in `/locations` ? Are they “archived” perhaps? Is the “Location” checkbox checked when you edit them?

The dashboard map specifically shows geometries of Land, Water, and Structure assets… but only ones that are “active” (not archived) and designated as “Locations” (with the “Is location” checkbox checked on them).

---

<div class="post-metadata">

**Author:** ![oliverp44](https://avatars.discourse-cdn.com/v4/letter/o/d26b3c/32.png) [@oliverp44](https://farmos.discourse.group/u/oliverp44)\
**Post date:** [December 20, 2021, 3:06pm UTC](https://farmos.discourse.group/t/hosting-farmos-for-dummies/978/20 "2021-12-20T15:06:59Z")

</div>

Just deleted all the location assets (they were imported so easy to replace) to see if that was the issue but still no change. The locations are all active and shown as locations.

 ![image](https://global.discourse-cdn.com/free1/uploads/farm_os/original/1X/dfaf569eb6061a1c585de227dd037703f54b2c77.jpeg)

[Next page](https://farmos.discourse.group/t/hosting-farmos-for-dummies/978.md?page=2)
