GithubHelp home page GithubHelp logo

Ubuntu docs seem incomplete about docs HOT 5 OPEN

adamkdean avatar adamkdean commented on August 21, 2024
Ubuntu docs seem incomplete

from docs.

Comments (5)

Konafets avatar Konafets commented on August 21, 2024 1

@adamkdean What do you expect?

from docs.

jasonvarga avatar jasonvarga commented on August 21, 2024 1

To me, this doesn't match what I'd expect.

This is a clone of the statamic/statamic repo which is a Statamic site. The webroot is the public subdirectory. This all looks expected.

The guide also explains setting up nginx and points the site to that public subdirectory. Did you do the nginx bit?

from docs.

adamkdean avatar adamkdean commented on August 21, 2024

Thanks for coming back to me @Konafets @jasonvarga.

I think the page may be out of date — I've since sorted the issue and have it working both on Ubuntu 22.04 and within a docker container without the use of Sails (which may be of interest to folks like me who are unfamiliar and prefer more traditional setups.)

With Ubuntu 20.04, I found that there were compatibility issues with Statamic v4.0.6 and the PHP version (7) bundled with 20.04. While I found resources to upgrade to PHP 8 on Ubuntu 20.04, but given there's only another year of support for 20.04, I figured I'd try 22.04 instead.

I spun up a fresh 22.04 box and installed dependencies etc. It comes with PHP 8 so that solved that issue. In the tutorial however there are still a few issues:

  1. php-curl is missing from the required extensions
  2. /var/www doesn't exist prior to nginx being installed
  3. Cannot (should not?) run composer as superuser so requires temporarily taking over /var/www as non-root user
  4. Missing instruction to symlink the sites-available config file into the sites-enabled config.

This last one was what tripped me up. Easy thing to miss. (Also the public dir, that threw me as well, I missed that detail, but in terms of config it was correct.)

If it'd help, I'd be happy to update the document with the additional steps above.

Additionally, I now have this running in docker without the use of Sails — is this something you'd consider adding to the docs? e.g. Docker with Sails, Docker manual etc. I'm still working a version of the container that doesn't require building, just running.

from docs.

adamkdean avatar adamkdean commented on August 21, 2024

I've now put together a container image so this can be span up easily (docker run -d --name statamic -p 80:80 -e DOMAIN=test.example.com adamkdean/statamic) but looking through the docs, it's not 100% clear to me where persistent files are stored (content, storage?) — is there any guidance on this? Thanks

from docs.

Related Issues (20)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.