Skip to content

📙 Clarification about Parse Server installation methods #878

Open
Open
📙 Clarification about Parse Server installation methods#878

Description

@MrMartinR
MrMartinR
opened on Jun 11, 2022

New Feature / Enhancement Checklist

Current Limitation

Confusing about Installation

Feature / Enhancement Description

Be more clear about the different installation options / unify the info in one place

Example Use Case

I think I mess up my installation because I did install parse-server from npm and also I did run the bootstrap file, and I think I have 2 parse servers,
I think I was running the bootstrap version but I had some drama when I tried to add parse server to PM2, adding environment variables, etc..

Also I need clarification about this, because I was editing the docs and In the ubuntu deployment I stated to perform both installations (via npm and via bootstrap)

Also the files and folder structure are not the same
Screen Shot 2022-06-11 at 17 06 03

btw: the key generations in the bootstrap script doesn't work at least in ubuntu

Alternatives / Workarounds

Learn more about devOps

3rd Party References

none

Activity

  1. parse-github-assistant commented on Jun 11, 2022

    @parse-github-assistant
    parse-github-assistantbot
    on Jun 11, 2022

    Thanks for opening this issue!

    • 🎉 We are excited about your ideas for improvement!

  2. mtrezza commented on Jun 11, 2022

    @mtrezza
    mtrezza
    on Jun 11, 2022
    Member

    Transferring to docs, since this seems to be a docs issue, not a product issue.

  3. mtrezza
    transferred this issue fromparse-community/parse-serveron Jun 11, 2022

  4. mtrezza commented on Jun 11, 2022

    @mtrezza
    mtrezza
    on Jun 11, 2022
    Member

    I think I mess up my installation because I did install parse-server from npm and also I did run the bootstrap file, and I think I have 2 parse servers,

    Where did you see an instruction to execute both?

    Looking at the Parse Server README I see only this:

    $ npm install -g parse-server mongodb-runner
$ mongodb-runner start
$ parse-server --appId APPLICATION_ID --masterKey MASTER_KEY --databaseURI mongodb://localhost/test

  5. MrMartinR commented on Jun 12, 2022

    @MrMartinR
    MrMartinR
    on Jun 12, 2022
    ContributorAuthor

    I haven't see both in the same place, I saw the npm version in the README and the Bootstrap version in the Docs Getting Started Section.
    Use the bootstrap script to set up Parse Server in the current directory.

    I assumed? that maybe the npm was some library that parse-server needed and the "official" parse server installation was the Bootstrap version that maybe also installed the npm... 🤷‍♂️
    Or maybe I thought that the npm was 'the one' and the Bootstrap was the parse-server I need to clone/fork to contribute to the project 🤷‍♂️ I just installed both🤦‍♂️

    To be honest, no idea what is the difference, are they the same?

  6. mtrezza commented on Jun 12, 2022

    @mtrezza
    mtrezza
    on Jun 12, 2022
    Member

    The bootstrap script installs parse server - and more. You can take a look at the script to see whether it's useful for you. The npm i -g parse-server installs parse server globally, which makes it accessible from anywhere in the CLI but may make it more difficult for Parse Server development when switching between versions of Parse Server frequently.

    What is right for you depends on what you want to do. Either guide works, but with different implications.

    I agree that this may seem confusing for new developers who are just getting started with Node.js development. A proper guide should consolidate and offer both approaches to set up Parse Server and explain the differences. But it doesn't make any sense to duplicate that information in the README and the docs. The README should be stripped of all docs-like content and that content should move into the docs.

    If you want to look more into this, see the npm docs link I posted above and study the bootstrap script to see what it does. It may be a bit of work, but the learning and insight should be worth it. And maybe you want to open a PR afterwards to improve the docs in that regard.

  7. mtrezza
    changed the title [-]Parse Server Installation Methods[/-] [+]Clarify Parse Server installation methods[/+] on Jun 12, 2022

  8. MrMartinR commented on Jun 12, 2022

    @MrMartinR
    MrMartinR
    on Jun 12, 2022
    ContributorAuthor

    I agree 100% that the README (and the wiki) should not contain any doc related stuff... I am gonna try to dig into those 2 options and edit the AWS Deployment Guide (it states to do both installs)...
    probably more questions will pop in my head, should I come back here? or use Slack??

  9. mtrezza commented on Jun 12, 2022

    @mtrezza
    mtrezza
    on Jun 12, 2022
    Member

    Great, it's best to discuss docs changes here, since it has more visibility and allows for collaboration. This issue is just to clarify the installation installations in the docs. If your changes are broader, then I suggest opening a separate issue.

  10. MrMartinR commented on Jun 12, 2022

    @MrMartinR
    MrMartinR
    on Jun 12, 2022
    ContributorAuthor

    I did refactor the AWS guide, I decided to install Parse Dashboard Globally and Parse-Server locally but without using the Bootstrap script, after checking the bootstrap I think is not worth to use it in the AWS deployment, only generates a couple of extra files...
    also I fix the block codes from js to json

  11. MrMartinR
    changed the title [-]Clarify Parse Server installation methods[/-] [+]📙 Clarification about Parse Server installation methods[/+] on Jun 30, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions