4 ms·

I like the idea. It looks like something that could work for me. Minor rant. I dislike the install section. It just assumes I already know everything about ho

I like the idea. It looks like something that could work for me. Minor rant. I dislike the install section. It just assumes I already know everything about how to do it. I ran into similar issues when I was trying to setup Kimai. Install instructions basically forced me to spend time hunting down howtos, resolving issues that came up during my attempt ( arrgh ), and later just throw my hands in the air as Kimai installer told me PHP version is too old ( tried XAAMP and WAMP ). I get that everyone's setup is different. I do. I just think a little more information in that section would be helpful.

larrywright 7y ago
When it comes to installing stuff like this, Docker is your friend.
- karatestomp 7y ago
  I love how much stupid single-project-or-service-specific deployment crap Docker has saved me from having to (re-)learn. The way it tends to encourage easier and better-documented configuration than the software packaged in it usually has is a huge bonus, too. My Samba config is a couple command line args per share, now. So much better than "OK, where does this distro store its Samba configs? Is it overridden by files anywhere else? Is this a real user or a 'Samba user' intended here? How do I add those again? Which section does this line go in?' It tends to do similar things for backups. You know what you need to back up because it's explicitly mapped to a directory or disk outside the Docker image. If you failed to map something you want to back up you'll notice immediately because whatever-it-is doesn't come back after destroying and re-creating the container. No hunting through /var or /opt or whatever. Once it's working just back up whatever's in those mapped resources.
  - larrywright 7y ago
    I can say without a doubt that I’ve tried a lot more software since Docker came on the scene. I don’t use node or php, and so installing anything that uses one of those was guaranteed to be hours of debugging something’s install when I just want to try it out. The only software I’ll try that isn’t packaged in a container is Go binaries. They’re the only thing that comes close to that (but only if there are no other dependencies).
stronglikedan 7y ago
There's a separate requirements section that's linked to at the start of the installation section. I think instructions for things like configuring a web server would be too granular. In this case, the concise installation section combined with the requirements section seems like just enough info.

larrywright 7y ago

When it comes to installing stuff like this, Docker is your friend.

karatestomp 7y ago
I love how much stupid single-project-or-service-specific deployment crap Docker has saved me from having to (re-)learn. The way it tends to encourage easier and better-documented configuration than the software packaged in it usually has is a huge bonus, too. My Samba config is a couple command line args per share, now. So much better than "OK, where does this distro store its Samba configs? Is it overridden by files anywhere else? Is this a real user or a 'Samba user' intended here? How do I add those again? Which section does this line go in?' It tends to do similar things for backups. You know what you need to back up because it's explicitly mapped to a directory or disk outside the Docker image. If you failed to map something you want to back up you'll notice immediately because whatever-it-is doesn't come back after destroying and re-creating the container. No hunting through /var or /opt or whatever. Once it's working just back up whatever's in those mapped resources.
- larrywright 7y ago
  I can say without a doubt that I’ve tried a lot more software since Docker came on the scene. I don’t use node or php, and so installing anything that uses one of those was guaranteed to be hours of debugging something’s install when I just want to try it out. The only software I’ll try that isn’t packaged in a container is Go binaries. They’re the only thing that comes close to that (but only if there are no other dependencies).

stronglikedan 7y ago

There's a separate requirements section that's linked to at the start of the installation section. I think instructions for things like configuring a web server would be too granular. In this case, the concise installation section combined with the requirements section seems like just enough info.